home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / pcvco13.arc / VCOLIB.DOC < prev    next >
Text File  |  1986-12-21  |  28KB  |  780 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.              ----------------------------------
  21.              PC-VCO: IBM PC Visual Conferencing
  22.              ----------------------------------
  23.               Face Library Maintenance
  24.              ----------------------------------
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32. PC-VCO is distributed freely and may be copied by anyone for any number
  33. of machines.  The author considers PC-VCO to be "shareware" or "freeware".
  34. If the program is found to be useful or entertaining, a contribution of
  35. $35.00 is requested.  If response warrants, PC-VCO will be enhanced and
  36. extended.  The author may be reached at:
  37.  
  38.  
  39.              R. (Scott) McGinnis
  40.              P.O. Box 3607 Mdse Mart
  41.              Chicago, IL 60654-0607
  42.  
  43.              PLINK, GEnie id: TARTAN
  44.  
  45.  
  46.  
  47.  
  48.                                 Version 1.3: 861222
  49.                                 R.McGinnis; Chicago
  50.  
  51. VCOLIB: PC-VCO Face Librarian
  52. Version 1.3: 861222
  53.  
  54.  
  55.                  Table of Contents
  56.                  -----------------
  57.  
  58.  
  59.  
  60. I.    Introduction  ................................................. page  1
  61.  
  62. II.    Running the program  .......................................... page  2
  63.  
  64. III.    VCOLIB Command Summary ........................................ page  3
  65.  
  66. IV.    Creating a Face File .......................................... page  4
  67.  
  68. V.    The Graphic Editor ............................................ page  5
  69.  
  70. VI.    Sharing your Face Files ....................................... page  7
  71.  
  72. VII.    Program Requirements .......................................... page  8
  73.  
  74. VIII.    Program and Author Information    ............................... page  9
  75.  
  76.  
  77.  
  78.  
  79.                 Appendices
  80.                 ----------
  81.  
  82.  
  83. A.    Face File Contents ............................................ page 10
  84.  
  85. B.    File formats .................................................. page 11
  86.  
  87. C.    Harry Chesley's VCO ........................................... page 13
  88.  
  89. D.    PACKIT files .................................................. page 14
  90.  
  91. E.    Command examples .............................................. page 15
  92.  
  93.  
  94.  
  95.  
  96. VCOLIB: PC-VCO Face Librarian                           Page  1
  97. Version 1.3: 861222
  98.  
  99.  
  100. I.    Introduction
  101.  
  102.  
  103.     PC-VCO is a terminal program for use on IBM PCs and network con-
  104.     ferencing facilities such as People/Link's PARTY, CompuServe's CB
  105.     simulator, and Delphi's conference areas.  The idea for PC-VCO was
  106.     derived from the VCO system, and its predecessor VMCO, developed
  107.     on the MacIntosh computer.  The VCO programs (PC and MacIntosh)
  108.     allow you to see the people you communicate with on-line, using
  109.     the graphic capabilities of the personal computer.
  110.  
  111.  
  112.     VCO was originally developed by Harry Chesley. It was followed by
  113.     VMCO (which is CIS specific), written by Bob Perez independant to
  114.     the development of VCO.  The current (MacIntosh) version of VCO is
  115.     almost an exact duplicate of Harry Chesley's original - the
  116.     original source code was converted by Mike Cohen and made to accept
  117.     several service formats.
  118.  
  119.  
  120.     The MacIntosh VCO allows the user to see the people talking on-
  121.     line through graphic Icons.  These are provided to the MacIntosh VCO
  122.     through 'Resource files' and are built using a 'Resource Editor'.
  123.     A MacIntosh VCO user must have a resource file for every speaker.
  124.     Charlie Brown and Snoopy Icons are used when a speaker is unknown.
  125.  
  126.  
  127.     VCOLIB Version 1.3 creates and maintains a library of Icons used
  128.     by PC-VCO.  Icons may be extracted from MacIntosh resource files
  129.     or may be created using a graphics editor (in VCOLIB).    Icons created
  130.     on the IBM PC may be put to a resource-type file, and uploaded for
  131.     MacIntosh VCO friends.
  132.  
  133.  
  134.     PC-VCO/VCOLIB may be copied freely and distributed to anyone for any
  135.     machine.  The author considers this to be "shareware" or "free-
  136.     ware".  If the program is found to be useful or entertaining, a
  137.     contribution is asked.    PC-VCO/VCOLIB will be extended and enhanced
  138.     if response warrants.
  139.  
  140.  
  141. VCOLIB: PC-VCO Face Librarian                           Page 2
  142. Version 1.3: 861222
  143.  
  144.  
  145. II.    Running the program
  146.  
  147.  
  148.     VCOLIB is invoked at the DOS prompt with the command:
  149.  
  150.     ------------------------------------------------------
  151.     "d>" VCOLIB <options>
  152.  
  153.     Where "d>" is the DOS prompt, and
  154.           <options> is: (<cmd> <Lib-File> (<parm> (,<parm> ...)))
  155.           where <parm>     is either an ID or a MacIntosh Face-file name,
  156.             <Lib-file> is the library file name to be used,
  157.           and   <cmd>      is one of: A,D,U,R,L,V, or M.
  158.  
  159.     Note: Specifying no commands at all will provide an abbreviated
  160.           HELP display summarizing available commands.
  161.     ------------------------------------------------------
  162.  
  163.     VCOLIB commands are summarized on the next page.
  164.  
  165.  
  166. VCOLIB: PC-VCO Face Librarian                           Page 3
  167. Version 1.3: 861222
  168.  
  169.  
  170. III.    VCOLIB Command Summary.
  171.  
  172.  
  173.     Command    Parameter Description
  174.     ---------  --------- --------------------------------------------------
  175.     (A)dd       Mac-File  Add Mac-File(s) to Lib-File.  You are given the
  176.                  opportunity to rename the entry from the ID
  177.                  specified in the Mac-File.  You may  (C)hange
  178.                  or (A)ccept the ID as given.  Duplicate IDs are
  179.                  not allowed in the Library.
  180.  
  181.     (R)eplace  ID         Replace an ID in Lib-File.  You are prompted for
  182.                  the MacIntosh face file to be used.  If the face
  183.                  file carries the same ID, the replace is performed
  184.                  with no comment.  If they differ, you are queried.
  185.                  Duplicate IDs are not allowed in the Library.
  186.  
  187.     (D)elete   ID         Delete an ID from Lib-File.  The indicated entry
  188.                  is marked deleted, and will be discarded upon the
  189.                  next ADD.
  190.  
  191.     (U)ndelete ID         Mark deleted entry not deleted.  If an entry
  192.                  marked deleted has not been re-used, it may be
  193.                  put back into service with this command.
  194.  
  195.     (M)odify   ID         Modify ID and name of an entry.  Further, any
  196.                  Icon in the entry may be modified through a
  197.                  simple graphics editor.
  198.  
  199.     (C)opy       ID         Copy an entry to a new entry in Lib File. You
  200.                  are prompted for an ID to name the new entry.
  201.                  The new ID may not duplicate an existing ID
  202.                  in the Lib-file.
  203.  
  204.     (O)utput   ID         Build a resource file of MacIntosh compatible
  205.                  format.  You will be prompted for a file name.
  206.  
  207.     (V)iew      (ID)         View the contents of Lib-File.  If you specify an
  208.                  ID, and it exists in Lib-file, it is displayed.
  209.                  You will be prompted for other IDs in any case.
  210.  
  211.     (L)ist             List entries in Lib-File.    Output may be re-
  212.                  directed to a printer.
  213.  
  214. VCOLIB: PC-VCO Face Librarian                           Page 4
  215. Version 1.3: 861222
  216.  
  217.  
  218. IV.    Creating a Face File
  219.  
  220.  
  221.     You can create a face file through the simple expedient of COPYing
  222.     a current face (naming the new entry), and then MODIFYing the new
  223.     entry.    The COPY command creates a new Library entry using an
  224.     existing entry.  The MODIFY command works on an existing entry,
  225.     allowing the ID, NAME, and Icons of the entry to be changed.
  226.  
  227.  
  228.     After the ID and NAME have been changed, you will be asked if the
  229.     Icons are to be edited.  If you respond "Yes", VCOLIB will try to
  230.     switch to graphics mode (if your PC does not have a CGA, the
  231.     attempt will fail), and you will be asked which Icon is to be
  232.     modified.  Select the ICON number you wish to modify.
  233.  
  234.  
  235.     After choosing an ICON, you will be asked which ICON to use as a
  236.     base for the edit.  You may start the edit session with any of the
  237.     displayed Icons.  The result of the edit will overlay the ICON you
  238.     initially selected to modify - it will not change the ICON you've
  239.     chosen as a base.  Once you have specified which ICON is to be
  240.     modified, and which ICON you will use as a starting point, you
  241.     enter the graphic editor (see below: "V. The Graphic Editor").
  242.  
  243.  
  244.     The editor displays the ICON as it appears on the PC-VCO screen
  245.     to the right, and displays a magnified ICON (4x) with a cursor
  246.     (initially in the top left corner) to the left.  Changes to pixels
  247.     are reflected in both pictures simultaneously.    Cursor keys are
  248.     used to position the cursor.  The INSert and DELete keys turn the
  249.     pixel at the cursor on and off.
  250.  
  251.  
  252.     A carriage return finishes the edit and updates the face entry.
  253.     An ESCape cancels the edit without modification to any ICONs.
  254.  
  255.  
  256.     Once an entry has been created in the library, it is immediately usable
  257.     by PC-VCO.  When a speaker using the entry's ID is recognized, normal
  258.     expression faces are displayed (Icons 260 and 360).  However, to
  259.     be seen by other VCO users, the entry must be OUTPUT to a file (on
  260.     your PC) and the file uploaded to a BBS or service (see below: "VI.
  261.     Sharing your face file").
  262.  
  263.  
  264.  
  265. VCOLIB: PC-VCO Face Librarian                           Page 5
  266. Version 1.3: 861222
  267.  
  268.  
  269. V.    The Graphic Editor
  270.  
  271.  
  272.     You enter the graphic editor through the modify command.  To enter
  273.     the graphics editor, you must answer 'yes' to the question "do you
  274.     wish to modify any ICONs, you must select an ICON to be updated,
  275.     and you must select an ICON with which to start.
  276.  
  277.  
  278.     The editor displays the ICON as it appears on the PC-VCO screen
  279.     to the right, and displays a magnified ICON (4x) with a cursor
  280.     (initially in the top left corner) to the left.  Changes to pixels
  281.     are reflected in both pictures simultaneously.
  282.  
  283.  
  284.     In the graphics editor, the following keys are active:
  285.  
  286.     Home        This key positions the cursor to the top left corner.
  287.             If the PEN is on, the point at the cursor will change.
  288.  
  289.     End        This key positions the cursor to the bottom left corner.
  290.             If the PEN is on, the point at the cursor will change.
  291.  
  292.     PgDn        This key positions the cursor to the bottom right corner.
  293.             If the PEN is on, the point at the cursor will change.
  294.  
  295.     PgUp        This key positions the cursor to the top right corner.
  296.             If the PEN is on, the point at the cursor will change.
  297.  
  298.     Cursor up    This key moves the cursor up one point.  At the top of
  299.             the display, the cursor will wrap to the bottom.  If
  300.             the PEN is on, the point at the new cursor will change.
  301.  
  302.     Cursor left    This key moves the cursor left one point.  At the side
  303.             of the display, the cursor will wrap oppositely.  If
  304.             the PEN is on, the point at the new cursor will change.
  305.  
  306.     Cursor down    This key moves the cursor down one point.  At the bottom
  307.             the display, the cursor will wrap to the top.  If the
  308.             PEN is on, the point at the new cursor will change.
  309.  
  310.     Cursor right    This key moves the cursor right one point.  At the side
  311.             of the display, the cursor will wrap oppositely.  If
  312.             the PEN is on, the point at the new cursor will change.
  313.  
  314.  
  315. VCOLIB: PC-VCO Face Librarian                           Page 6
  316. Version 1.3: 861222
  317.  
  318.  
  319. V.    The Graphic Editor (continued)
  320.  
  321.  
  322.     Active keys in the graphic editor (continued)...
  323.  
  324.     Ins        This key turns the point at the cursor off (dark).
  325.  
  326.     Del        This key turns the point at the cursor on (light).
  327.  
  328.     Alt-C        This key clears all points in the ICON (sets all dark).
  329.  
  330.     Alt-S        This key sets all points on (sets all light).
  331.  
  332.     Alt-R        This key reverses all points in the image.
  333.  
  334.     Alt-P        This key turns the PEN on and off.  When the PEN is on,
  335.             a message is displayed at the top of the screen.  PEN
  336.             drawing is very convenient in may cases.
  337.  
  338.     Esc        This key cancels any changes and returns you to the
  339.             view screen.  No changes will be made to any ICONs.
  340.  
  341.     <return>    This key terminates the graphic editor and modifies the
  342.             ICON you selected with your changes.
  343.  
  344.  
  345.     The graphic editor uses the method called 'fatbits'.  The ICON is dis-
  346.     played in its correct size, and also magnified 4 times.  Magnification
  347.     allows a cursor to be displayed within the picture.
  348.  
  349.  
  350.     Most ICONs used in VCO have a light background with dark points out-
  351.     lining or shading the drawing.    Alt-S allows you to make a blank canvas
  352.     on which to draw.  Once you've drawn your first ICON, you can copy it
  353.     over top of all the rest, and then make changes to each as appropriate.
  354.  
  355.  
  356.     It may seem intimidating at first to have to create 18 images (9 for
  357.     the seated display, and 9 for the speaker's box).  However, it turns
  358.     out to be considerably more simple than it appears, especially if you
  359.     start out with someone else's ICONs that are similar to the set you
  360.     visualize for yourself.
  361.  
  362.  
  363.     In any case, you can always 'Esc' cancel the editor and make no changes.
  364.     You have an opportunity to experiment, and throw away the result if you
  365.     don't like it.  So... have at it!
  366.  
  367. VCOLIB: PC-VCO Face Librarian                           Page 7
  368. Version 1.3: 861222
  369.  
  370.  
  371. VI.    Sharing your Face File
  372.  
  373.  
  374.     In order for other VCO/PC-VCO users to see your face, you must
  375.     share your face file.  VCOLIB will OUTPUT a library entry to a
  376.     MacIntosh type resource file.  This file may be uploaded to a
  377.     BBS or service.  Other VCO/PC-VCO users then download the file
  378.     and add it to their library.
  379.  
  380.  
  381.     Please note that when you OUTPUT a face to a file for uploading,
  382.     each system to which you wish to upload has differing requirements.
  383.     VCOLIB will query the target system, and prepare the file accordingly.
  384.     You cannot upload a file prepared for CIS to GEnie, for example, and
  385.     expect GEnie users to be able to use the file.    If you use several
  386.     systems, you must prepare a different face file for each.
  387.  
  388.  
  389.     Included with this distribution of PC-VCO are 6 face files (in
  390.     the library file PC-VCO.FLB).  You may see the entries in this
  391.     library with the command:
  392.  
  393.        "d>" VCOLIB V PC-VCO.FLB
  394.  
  395.     Kelly, Mike, Bob, and OZMA have all shared VCO with me during
  396.     the development of this program.  Their faces are included.
  397.     The entry PC-VCO-DEFAULT is the Charlie Brown entry used for IDs
  398.     not contained in the library.  I am TARTAN.
  399.  
  400.  
  401.     One note - Some VCO/VMCO users pack resource files together in
  402.     a single file and upload the one file.    This version of VCOLIB
  403.     does not accept a Packit format face library.  Each resource
  404.     file must be extracted from a Packit format file (on a MacIntosh,
  405.     or with the utility 'unPACKIT' released separately) and then
  406.     entered in to the PC-VCO face Library.
  407.  
  408.  
  409.  
  410.  
  411. VCOLIB: PC-VCO Face Librarian                           Page 8
  412. Version 1.3: 861222
  413.  
  414.  
  415. VIII.    Program Requirements
  416.  
  417.  
  418.     This program can only function on an IBM PC or DOS compatible machine.
  419.     The MODIFY and VIEW commands require a color graphics display adapter.
  420.     Although an EGA would provide a more close resemblance to the MacIntosh
  421.     environment, no use of the EGA is planned at this time.
  422.  
  423.  
  424.     VCOLIB does direct to screen buffer fetches and stores - so compati-
  425.     bility is an important issue.  VCOLIB disk I/O is done through the
  426.     'Handle' oriented I/O routines added with DOS 2.0.  Therefore DOS
  427.     2.0 is also a requirement.
  428.  
  429.  
  430.     The current version's memory requirements are modest.  Each Icon uses
  431.     128 bytes.  Each ID can have 18 Icons (two for each expression - one
  432.     for display and another for speaking).    VCOLIB will run in 64K.
  433.  
  434.  
  435. VCOLIB: PC-VCO Face Librarian                           Page 9
  436. Version 1.3: 861222
  437.  
  438.  
  439. VIII.    Program and Author Information
  440.  
  441.  
  442.     This program was written using Microsoft Macro-Assembler.  The author
  443.     likes assembler.  Assembly language is an entirely appropriate vehicle
  444.     for some of the program, and a not-inappropriate vehicle for the rest
  445.     of it.
  446.  
  447.  
  448.     VCOLIB and PC-VCO were written by R. Scott McGinnis of Chicago,
  449.     Illinois.  My ID on PLINK and on GEnie is TARTAN.  Comment and
  450.     suggestions are welcomed.
  451.  
  452.              R. (Scott) McGinnis
  453.              P.O. Box 3607 Mdse Mart
  454.              Chicago, IL 60654-0607
  455.  
  456.  
  457.     Credit for information on the VCO must be given to Kelly Major and
  458.     Mike Cohen.  Both Kelly and Mike worked to make PC-VCO possible.
  459.     I must also thank my wife, Elizabeth, who allowed me to isolate
  460.     myself (literally) for 5 months to write this, and who further read
  461.     me hex dumps while I entered code.
  462.  
  463.  
  464.     VCOLIB (Version 1.3) may be distributed freely, with the caveat
  465.     that the Author information displayed at program termination is
  466.     not removed.  If you find PC-VCO useful or entertaining, a contrib-
  467.     ution is requested.  Should response warrant it, I will continue to
  468.     support this product.
  469.  
  470.  
  471.     Most of the hardware names and software names in this document are
  472.     trademarks or trade names of specific manufacturers.
  473.  
  474.  
  475. VCOLIB: PC-VCO Face Librarian                           Page 10
  476. Version 1.3: 861222                           Appendices
  477.  
  478.  
  479. A.    Face File Contents
  480.  
  481.  
  482.     VCOLIB maintains a Library of faces, each face associated with an
  483.     ID.  The Library may include up to 100 face entries.  Each entry
  484.     contains:
  485.  
  486.     .  The ID associated with the face(s)
  487.  
  488.     .  The personal name of the individual (optional and unused by
  489.        both MacIntosh VCO and PC-VCO); Field STR1000
  490.  
  491.     .  The speaking rate (words per minute) - unused by the current
  492.        speech driver; Field STR 600
  493.  
  494.     .  The speaking pitch (frequency) - unused by the current speech
  495.        driver; FIeld STR 610
  496.  
  497.     .  Faces.  Nine expressions are defined, each with two modes:
  498.        Display, and speaking.  Using MacIntosh terminology, these are:
  499.  
  500.        Expression      Face Icon    Speaking Icon
  501.        -------------- -----------  -------------
  502.        Normal          260       360
  503.        Grin           261       361
  504.        Laughing          262       362
  505.        Surprised          263       363
  506.        Anger          264       364
  507.        Zzzzzz          265       365
  508.        Sad              266       366
  509.        Away from CRT      267       367
  510.        Question          268       368
  511.  
  512.  
  513.     PC-VCO reserves the ID "PC-VCO-DEFAULT" for itself, to be used for
  514.     faces displayed when the ID is unknown.  The current distribution
  515.     contains Charlie Brown and Snoopy Icons for this ID.  If the entry
  516.     is marked deleted, PC-VCO will revert to text Icons for unknown IDs.
  517.     If the entry is marked deleted, and subsequent ADDs are performed,
  518.     the entry will be lost.
  519.  
  520.  
  521.     A second face-set has been provided with this version of VCOLIB and
  522.     PC-VCO.  It has been ID'd 'ANOTHER-DEFAULT' in the library.  You may
  523.     view the entry with the command:
  524.  
  525.         'd>' VCOLIB V PC-VCO.FLB ANOTHER-DEFAULT
  526.  
  527.     This face-set was created by Howard Hoffman.  It makes an interesting
  528.     contrast to the Charlie Brown faces.  By renaming 'PC-VCO-DEFAULT'
  529.     to, say 'OLD-DEFAULT', and renaming 'ANOTHER-DEFAULT' to become
  530.     'PC-VCO-DEFAULT', PC-VCO will use it for unknown faces.
  531.  
  532. VCOLIB: PC-VCO Face Librarian                           Page 11
  533. Version 1.3: 861222                            Appendices
  534.  
  535.  
  536. B.    File formats
  537.  
  538.  
  539.     Library file structure.
  540.  
  541.     Version 1.0 of VCOLIB uses a very simple structure for the
  542.     LIB file.  The structure consists of a preamble, followed
  543.     by fixed length slots - each slot representing one 'face'.
  544.  
  545.     ------ Preamble format --------------------------------------------
  546.  
  547.     Byte 0        1       2      3     4    5      6      7      8
  548.          +------+------+------+------+------+------+------+------+->
  549.          ! "V"  ! "C"  ! "O"  ! "L"  ! "I"  ! "B"  ! Ver  ! Rev  !
  550.          +------+------+------+------+------+------+------+------+->
  551.  
  552.     Byte        8       9      10     11    12     13     14     15     16
  553.           >-+------+------+------+------+------+------+------+------+
  554.             ! Yr lsb-msb  ! Da     ! Mo    ! Mi   ! Hr   ! 100th! Sec  !
  555.           >-+------+------+------+------+------+------+------+------+
  556.  
  557.     Byte        17       18      19     20    21     22
  558.           >-+------+------+------+------+------+
  559.             ! IDln ! NmLn ! ICLn ! Max    ! Cnt  !
  560.           >-+------+------+------+------+------+
  561.  
  562.     Where: Ver -------> Creating program version # (ASCII)
  563.            Rev -------> Creating program revision # (ASCII)
  564.            Yr --------> Year # (Stored lsb/msb)
  565.            Mo --------> Month # (1-12); note reversal
  566.            Da --------> Day # (1-31); note reversal
  567.            Hr --------> Hour # (0-23); note reversal
  568.            Mi --------> Minute # (0-59); note reversal
  569.            Sec -------> Second # (0-59); note reversal
  570.            100th -----> 1/100 count; note reversal
  571.            IDLn ------> Maximum length in bytes of ID field
  572.            NmLn ------> Maximum length in bytes of Name field
  573.            ICLn ------> Size in bytes of each ICON field
  574.            Max -------> Max size of Library (in slots)
  575.            Cnt -------> Current count of lib slots
  576.  
  577. VCOLIB: PC-VCO Face Librarian                           Page 12
  578. Version 1.3: 861222                            Appendices
  579.  
  580.  
  581. B.    File formats (continued)
  582.  
  583.  
  584.     Library file structure (continued)
  585.  
  586.     ------ Face slot format -------------------------------------------
  587.  
  588.     Each slot of the library represents one face.  The structure
  589.     declared below controls the format of the slot.  The fields
  590.     are laid out and used as follows:
  591.  
  592.     Byte 0           20      21        41     42     43
  593.          +-----/ /-----+------+-----/ /-----+------+------+->
  594.          ! ID       ! Del  ! Name    ! Rate          !
  595.          +-----/ /-----+------+-----/ /-----+------+------+->
  596.  
  597.     Byte        43       44      45        63          191        319
  598.           >-+------+------+-----/ /-----+-----/ /-----+------+------+->
  599.             ! Pitch      ! ICON Map    ! ICON_260    ! ICON_261    !
  600.           >-+------+------+-----/ /-----+-----/ /-----+------+------+->
  601.  
  602.     Byte        ...    1215      1343           3239         3367
  603.           >-+------+-----/ /-----+-----/ /-----+------+------+
  604.             ! ...  ! ICON_360     ! ...           ! ICON_368    !
  605.           >-+------+-----/ /-----+-----/ /-----+------+------+
  606.  
  607.     ID -----------> This field represents the ID for the face.
  608.     Del ----------> This field, of not zero, indicates unused slot.
  609.     Name ---------> This field carries a name for the face.
  610.     Rate ---------> This field carries a 16 bit rate for speaking (WPM)
  611.     Pitch --------> This field carries a 16 bit pitch for speaking (CPS)
  612.     ICON_Map -----> This set of flags indicates whether or not certain
  613.             faces in the arrays below have been filled in.
  614.             0 => ICON not present.    18 bytes, one per ICON.
  615.     ICON_260/268 -> These bitmaps are the 9 ICONs for display (4x32)
  616.     ICON_360/368 -> These bitmaps are the 9 ICONs for speaking (4x32)
  617.  
  618.  
  619. VCOLIB: PC-VCO Face Librarian                           Page 13
  620. Version 1.3: 861222                           Appendices
  621.  
  622.  
  623. C.    Harry Chesley's VCO
  624.  
  625.  
  626.     This version of PC-VCO was written to be compatible with Mike Cohen's
  627.     MacIntosh VCO as used on PLINK.  Mike derived his VCO from Harry
  628.     Chesley's original work.  The ICON numbers used by both Harry and
  629.     Mike overlap.  The string fields (NAME, RATE, and PITCH) are different.
  630.  
  631.  
  632.     You may add files created for either VCO to PC-VCO's face library.
  633.     If the input is from a file created for Harry Chesley's VCO, certain
  634.     changes must be made.  These can be accomplished with the MODIFY
  635.     command, and are:
  636.  
  637.     .  The personal name of the individual (optional and unused by
  638.        both MacIntosh VCO and PC-VCO);  This field is not normally carried
  639.        by files created for Harry Chesley's VCO.  It may be added with
  640.        the MODIFY command.
  641.  
  642.     .  The speaking rate (words per minute) and pitch (frequency).    These
  643.        fields are carried by files created for Harry Chesley's VCO, but with
  644.        different IDs.  The IDs are STR 256 and STR 257, respectively, for
  645.        Harry Chesley's VCO.   VCOLIB will ignore the fields.  They may be
  646.        set with the MODIFY command.  However, PC-VCO doesn't use them.
  647.  
  648.     .  Faces.  Eight expressions are defined, each with two modes:
  649.        Display, and speaking.  Using MacIntosh terminology, these are:
  650.  
  651.                    Mike Cohen's VCO          Harry Chesley's VCO
  652.               -------------------------- --------------------------
  653.        Expression      Face Icon    Speaking Icon Face Icon      Speaking Icon
  654.        -------------- -----------  ------------- -----------  -------------
  655.        Normal          260       360         260          360
  656.        Grin           261       361         <none>       <none>
  657.        Laughing          262       362         261          361
  658.        Surprised          263       363         265          365
  659.        Anger          264       364         263          363
  660.        Zzzzzz          265       365         264          364
  661.        Sad              266       366         262          362
  662.        Away from CRT      267       367         267          367
  663.        Question          268       368         266          366
  664.  
  665.        ICONs added from a file created for Harry Chesley's VCO are auto-
  666.        matically moved around to match the enumeration given above for Mike
  667.        Cohen's VCO.  There is no differentiation in Harry Chesley's VCO
  668.        between 'grin' and 'laughing'... so 'happy' is replicated for both.
  669.  
  670.  
  671. VCOLIB: PC-VCO Face Librarian                           Page 14
  672. Version 1.3: 861222                            Appendices
  673.  
  674.  
  675. D.    PACKIT files
  676.  
  677.  
  678.     MacIntosh users often pack multiple files into a single file for
  679.     efficiency and data compression.  PACKIT files cannot be accepted
  680.     by VCOLIB.  When VCOLIB was written, the format for a PACKIT
  681.     archive (file.PIT) was not available to me.  It is now.
  682.  
  683.  
  684.     A utility program has been released separately to deal with packed
  685.     files.    The program is named unPACKIT, and will unpack files that
  686.     have been packed by PACKIT versions I, II and III (though it will
  687.     not decode encoded PACKIT III files).  PIT files may be obtained from
  688.     the several services, unpacked, and the unpacked contents added into
  689.     PC-VCO's face library.
  690.  
  691.  
  692.     unPACKIT was released separately.  However, I consider it a part of
  693.     the PC-VCO package.  If you have subscribed to PC-VCO, consider it
  694.     free for your use.  If you haven't subscribed to PC-VCO, and have
  695.     use for unPACKIT, I've asked for a separate subscription.
  696.  
  697.  
  698. VCOLIB: PC-VCO Face Librarian                           Page 15
  699. Version 1.3: 861222                            Appendices
  700.  
  701.  
  702. E.    Command Examples
  703.  
  704.  
  705.     To obtain a quick overview (a help display, if you wish), enter:
  706.  
  707.           VCOLIB
  708.  
  709.     (The following examples assume that the face library you wish to
  710.      employ is PC-VCO.FLB.    VCOLIB will work on any face library.)
  711.  
  712.     To List library entries, enter:
  713.  
  714.           VCOLIB L PC-VCO.FLB    -or-   VCOLIB > PRN L PC-VCO.FLB
  715.  
  716.     To view the library entry for the ID "TARTAN", enter
  717.  
  718.           VCOLIB V PC-VCO.FLB TARTAN
  719.  
  720.     To add an entry to the library from a file you've downloaded, enter:
  721.  
  722.           VCOLIB A PC-VCO.FLB <file>
  723.  
  724.           where <file> is the name you gave to the file you downloaded.
  725.           PC-VCO will tell you the ID represented by the file, and ask
  726.           for approval to update the file.    If the ID already exists in
  727.           your library, you will have the opportunity to change the (new)
  728.           ID, or to replace the existing entry.
  729.  
  730.     To delete the entry for TARTAN in the library, enter:
  731.  
  732.           VCOLIB D PC-VCO.FLB TARTAN
  733.  
  734.           if you list the library now, the entry will appear, but
  735.           be marked 'deleted'.
  736.  
  737.     To undelete the entry for TARTAN in the library, enter:
  738.  
  739.           VCOLIB U PC-VCO.FLB TARTAN
  740.  
  741.           note that you can recover an entry you've deleted immediately
  742.           after you delete it.  The first (A)dd, (R)eplace, or (C)opy
  743.           performed after the delete will use the deleted entry's space.
  744.           After that, the entry can no longer be recovered.
  745.  
  746.     To copy an entry in the library to a new entry, enter:
  747.  
  748.           VCOLIB C PC-VCO.FLB <ID>
  749.  
  750.           where <ID> is the entry you want to copy.  A new entry will be
  751.           created, and you will be asked for a (new) ID for the entry.
  752.  
  753.  
  754. VCOLIB: PC-VCO Face Librarian                           Page 16
  755. Version 1.3: 861222                            Appendices
  756.  
  757.  
  758. E.    Command Examples (continued)
  759.  
  760.  
  761.     To modify an entry in the library, enter:
  762.  
  763.           VCOLIB M PC-VCO.FLB <ID>
  764.  
  765.           where <ID> is the entry you want to modify.  Normally, you would
  766.           copy an entry and modify the copy.  (M)odify allows you to change
  767.           the ID for an entry, the NAME (which PC-VCO doesn't use), and to
  768.           edit the ICONs.
  769.  
  770.     To generate a file (for uploading) from the library, enter:
  771.  
  772.           VCOLIB O PC-VCO.FLB <ID>
  773.  
  774.           where <ID> is the entry you want to output.  You will be asked
  775.           for a file name to be used, and the system to which the file will
  776.           be uploaded.  VCOLIB will create (or replace, if the file already
  777.           exists) a file that you can then upload for other VCO users...
  778.           both PC and MacIntosh.
  779.  
  780.